---
title: Pelican에서 마이그레이션
description: 기존 Pelican 프로젝트를 Astro로 마이그레이션하기 위한 팁
type: migration
stub: true
framework: Pelican
i18nReady: true
---

import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'

[Pelican](https://getpelican.com)은 Python을 기반으로 구축된 오픈 소스 정적 사이트 생성기입니다.

## Pelican과 Astro의 주요 유사점

Pelican과 Astro는 프로젝트 마이그레이션에 도움이 되는 몇 가지 유사점을 공유합니다.

- Pelican과 Astro는 모두 블로그와 같은 [콘텐츠 중심 웹사이트](/ko/concepts/why-astro/#콘텐츠-중심)에 이상적으로 적합한 정적 사이트 생성기입니다.

- Pelican과 Astro는 모두 페이지 메타데이터를 위한 프런트매터 YAML 속성을 포함하여 [Markdown 작성](/ko/guides/content/#markdown-authoring)을 기본적으로 지원합니다. 그러나 Astro는 Pelican에 비해 예약된 프런트매터 속성이 거의 없습니다. 기존 Pelican 프런트매터 속성 중 다수가 Astro에서 "특별"하지 않더라도 기존 Markdown 파일과 프런트매터 값을 계속 사용할 수 있습니다.

## Pelican과 Astro의 주요 차이점

Astro에서 Pelican 사이트를 다시 빌드하면 몇 가지 중요한 차이점을 발견할 수 있습니다.

- Pelican은 Markdown 및 reStructured Text (`.rst`)로 콘텐츠 작성을 지원합니다. Astro는 [Markdown 및 MDX 파일에서 페이지 생성](/ko/guides/markdown-content/)을 지원하지만 reStructured Text는 지원하지 않습니다.

- Pelican은 템플릿 작성을 위해 HTML 파일과 Jinja 구문을 사용합니다. [Astro 구문](/ko/basics/astro-components/)은 JSX와 유사한 HTML 상위 집합입니다. 유효한 모든 HTML은 유효한 `.astro` 구문입니다.

- Pelican은 블로그와 같이 콘텐츠가 풍부한 웹사이트를 빌드하도록 설계되었으며 Astro에서 직접 빌드해야 하는 몇 가지 블로그 기능이 내장되어 있습니다. 대신 Astro는 [공식 블로그 테마](https://github.com/withastro/astro/tree/latest/examples/blog)에 포함된 이러한 기능 중 일부를 제공합니다.

## Pelican에서 Astro로 전환

Pelican 문서 사이트를 Astro로 변환하려면 공식 [Starlight 문서 테마 시작 템플릿](https://starlight.astro.build)으로 시작하거나 [테마 쇼케이스](https://astro.build/themes/)에서 더 많은 커뮤니티 테마를 탐색하세요.

공식 스타터 중 하나를 사용하여 새로운 Astro 프로젝트를 시작하려면 `--template` 인수를 `create astro` 명령에 전달할 수 있습니다. 또는 [GitHub의 기존 Astro 저장소에서 새 프로젝트를 시작](/ko/install/auto/#시작-템플릿)할 수 있습니다.

  <PackageManagerTabs>
    <Fragment slot="npm">
    ```shell
    npm create astro@latest -- --template starlight
    ```
    </Fragment>
    <Fragment slot="pnpm">
    ```shell
    pnpm create astro@latest --template starlight
    ```
    </Fragment>
    <Fragment slot="yarn">
    ```shell
    yarn create astro --template starlight
    ```
    </Fragment>
  </PackageManagerTabs>

기존 Markdown 콘텐츠 파일을 가져와 [Markdown 페이지를 만듭니다](/ko/guides/markdown-content/). 이러한 문서를 Pelican의 `content/` 폴더에서 Astro의 `src/pages/`로 복사하여 [파일 기반 라우팅](/ko/guides/routing/)을 활용할 수 있습니다. 파일이 어디에 있어야 하는지 알아보려면 [Astro의 프로젝트 구조](/ko/basics/project-structure/)를 읽어보세요.

Pelican은 사이트 레이아웃과 메타데이터의 대부분을 처리했을 수도 있습니다. `<head>` 페이지를 포함하여 Astro에서 템플릿 작성을 직접 관리하는 방법을 알아보려면 [Astro 레이아웃을 Markdown 페이지 래퍼로 빌드](/ko/basics/layouts/#markdownmdx-레이아웃)하는 방법을 읽어보세요.

포트폴리오나 블로그 등 다른 유형의 사이트를 변환하려면 [astro.new](https://astro.new)에서 더 많은 공식 시작 템플릿을 참조하세요. 각 프로젝트의 GitHub 저장소에 대한 링크는 물론 StackBlitz, CodeSandbox, Gitpod 온라인 개발 환경에서 작업 중인 프로젝트를 열 수 있는 원클릭 링크도 찾을 수 있습니다.

## 커뮤니티 자료

- 여러분의 자료를 추가하세요!
